feat(ui): strengthen generated-index readability and focus states - #360

#!/bin/bash
set -euo pipefail

repo="ContextualWisdomLab/html4tree"
pr="360"
sha="847141d51849ff796d037d9987602e8d5d406582"

echo "== PR metadata and head =="
gh pr view "$pr" --repo "$repo" --json number,url,state,isDraft,headRefOid,baseRefName,mergeStateStatus,reviewDecision,statusCheckRollup

echo "== Requested commit =="
gh api "repos/$repo/commits/$sha" --jq '{sha: .sha, parents: [.parents[].sha], message: .commit.message, verified: .commit.verification.verified}'

echo "== Diff from PR base to requested head: files/stat =="
base_sha="$(gh pr view "$pr" --repo "$repo" --json baseRefOid --jq .baseRefOid)"
gh api "repos/$repo/compare/$base_sha...$sha" --jq '{status, ahead_by, behind_by, total_commits, files: [.files[] | {filename,status,additions,deletions}]}'

echo "== Current check runs for requested head =="
gh api "repos/$repo/commits/$sha/check-runs?per_page=100" \
  --jq '.check_runs[] | {name,status,conclusion,details_url,started_at,completed_at}'

echo "== Current reviews =="
gh pr view "$pr" --repo "$repo" --json reviews \
  --jq '.reviews[] | {author: .author.login, state, commit: .commit.oid, submittedAt}'

echo "== Review-thread resolution state =="
gh api graphql -F owner="ContextualWisdomLab" -F name="html4tree" -F number="$pr" -f query='
query($owner: String!, $name: String!, $number: Int!) {
  repository(owner: $owner, name: $name) {
    pullRequest(number: $number) {
      reviewThreads(first: 100) {
        nodes {
          isResolved
          isOutdated
          path
          line
          comments(first: 10) { nodes { author { login } body } }
        }
      }
    }
  }
}' --jq '.data.repository.pullRequest.reviewThreads.nodes[] | select(.isResolved == false)'

echo "== Local requested-head identity and diff =="
git rev-parse HEAD
git cat-file -e "$sha^{commit}"
git diff --check "$base_sha" "$sha"
git diff --stat "$base_sha" "$sha"
git diff --name-status "$base_sha" "$sha"

echo "== Candidate Kotlin source and test structure =="
fd -t f -e kt . src | sort
ast-grep outline src/main/kotlin/html4tree/main.kt --items all --view expanded || true
ast-grep outline src/test/kotlin/html4tree/MainTest.kt --items all --view expanded || true

echo "== Relevant requested-head patch =="
git diff --no-ext-diff --unified=60 "$base_sha" "$sha" -- src/main/kotlin/html4tree/main.kt src/test/kotlin/html4tree/MainTest.kt CHANGELOG.md SECURITY.md .github/workflows/ci.yml gradle/wrapper/gradle-wrapper.properties

echo "== Policy and documentation candidates =="
fd -HI -t f '(^|/)(CONTRIBUTING|SECURITY|CODEOWNERS|README|CHANGELOG)(\..*)?$|^gradle/wrapper/gradle-wrapper\.properties$|^\.github/workflows/ci\.yml$' . | sort | xargs -r -n1 sh -c 'echo "--- $0"; sed -n "1,240p" "$0"'

#!/bin/bash
set -euo pipefail

repo="ContextualWisdomLab/html4tree"
pr="360"
sha="847141d51849ff796d037d9987602e8d5d406582"

echo "== Changed implementation: complete relevant range =="
sed -n '1,460p' src/main/kotlin/html4tree/main.kt

echo "== Generated-index readability tests =="
cat -n src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt

echo "== Existing CSP and coverage tests =="
cat -n src/test/kotlin/html4tree/CspHashTest.kt
cat -n src/test/kotlin/html4tree/CoverageTest.kt

echo "== Readability engineering record =="
cat -n docs/doctoring/generated-index-readability.md

echo "== CI workflow and Gradle test configuration =="
fd -HI -t f '^(ci\.yml|build\.gradle|build\.gradle\.kts|settings\.gradle|settings\.gradle\.kts)$' . | sort | while read -r f; do
  echo "--- $f"
  cat -n "$f"
done

echo "== Test annotations and modified-production-symbol references =="
rg -n -C2 --type kotlin '`@Test`|process_dir\s*\(|CSS_CONTENT|STYLE_HASH|empty-dir|dir-link' src/test/kotlin src/main/kotlin/html4tree/main.kt

echo "== Branch protection / required checks =="
gh api "repos/$repo/branches/master/protection" 2>&1 || true
gh api "repos/$repo/rules/branches/master" 2>&1 || true

echo "== Current checks and workflow run status for requested SHA =="
gh api "repos/$repo/commits/$sha/check-runs?per_page=100" \
  --jq '.check_runs[] | select(.name == "strix" or .name == "build" or .name == "Semgrep (multi-language SAST)" or .name == "coverage-evidence" or .name == "osv-scan" or .name == "trivy-fs" or .name == "dependency-review") | {name,status,conclusion,details_url}'
gh run list --repo "$repo" --commit "$sha" --limit 30 --json databaseId,name,status,conclusion,url,workflowName

echo "== Required-workflow source at requested SHA =="
for f in $(fd -HI -t f -e yml -e yaml .github/workflows | sort); do
  echo "--- $f"
  rg -n -C2 'jacoco|coverage|strix|semgrep|security|jobs:|name:' "$f" || true
done

#!/bin/bash
set -euo pipefail

repo="ContextualWisdomLab/html4tree"
sha="847141d51849ff796d037d9987602e8d5d406582"

echo "== Required Strix workflow at requested head =="
gh run list --repo "$repo" --commit "$sha" --workflow strix.yml --limit 5 \
  --json databaseId,name,status,conclusion,url,createdAt,updatedAt

echo "== Current Strix check run at requested head =="
gh api "repos/$repo/commits/$sha/check-runs?per_page=100" --jq \
  '.check_runs[] | select(.name == "strix") | {name,status,conclusion,details_url,started_at,completed_at}'

echo "== Current PR merge state and head =="
gh pr view 360 --repo "$repo" --json headRefOid,mergeStateStatus,reviewDecision,state

#!/bin/bash
set -euo pipefail

repo="ContextualWisdomLab/html4tree"
sha="847141d51849ff796d037d9987602e8d5d406582"
run_id="31062960798"

echo "== Strix workflow run =="
gh api "repos/$repo/actions/runs/$run_id" --jq \
  '{id,name,event,head_sha,status,conclusion,html_url,created_at,updated_at,run_started_at}'

echo "== Jobs in Strix workflow run =="
gh api "repos/$repo/actions/runs/$run_id/jobs?per_page=100" --jq \
  '.jobs[] | {name,status,conclusion,started_at,completed_at,html_url,steps: [.steps[] | {name,status,conclusion}]}'

echo "== Current requested-head check runs =="
gh api "repos/$repo/commits/$sha/check-runs?per_page=100" --jq \
  '.check_runs[] | {name,status,conclusion,details_url}'

echo "== Current PR identity and merge state =="
gh pr view 360 --repo "$repo" --json headRefOid,mergeStateStatus,reviewDecision,state